home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam 3 / Grand Slam 3.iso / 004 / !11wall.arj / SYSOP.DOC < prev    next >
Text File  |  1995-04-29  |  12KB  |  283 lines
  1.                          - Another Brick In The Wall -
  2.                               Sysop Documentation
  3.  
  4. Most BBSes today feature some sort of graffiti wall or oneliner door.  They
  5. provide a great outlet for short bursts of communication between callers, and
  6. facilitate the posting of material often too brief for the message bases;
  7. unfortunately, many of the graffiti wall doors available are lacking on the
  8. Sysop end of things, and provide few extra features. Another Brick In The Wall
  9. was written to address this problem.  Users of The Wall will enjoy its power
  10. and ease of use, while Sysops will enjoy its flexibility and control.
  11.  
  12.  
  13.                                  - Features -
  14.  
  15. o Assembly language serial I/O
  16. o Supports speeds up to 115.2k and 16550 UARTs
  17. o Internal ANSI emulation
  18. o Multitasker aware (DESQview, Windows, OS/2)
  19. o FOSSIL support (FOSSIL not required however)
  20. o Split-screen chat with word wrap
  21. o Multi-node compatible
  22.  
  23.  
  24.                              - Running The Wall -
  25.  
  26. The syntax for executing WALL.EXE is: WALL <config file> [local] [sysop] [...]
  27.  
  28. The config file is a 7-line text file:
  29.   Line 1: Dropfile type  [RA,WC2,WC3,SF,CL]
  30.   Line 2: Dropfile path/name
  31.   Line 3: BBS name
  32.   Line 4: Sysop first name
  33.   Line 5: Sysop last name
  34.   Line 6: COM port interrupt  [1-7, 0 for FOSSIL]
  35.   Line 7: Use error log?  [TRUE/FALSE]
  36.  
  37. Included is the utility MAKECFG.EXE, which will request this information and
  38. create a configuration file:
  39.  
  40. Name of config file to be created?  Name the file.  Ex: WALL.CFG.
  41.  
  42. Dropfile type?  Enter one of the following codes:  RA - DORINFO.DEF
  43.                                                   WC2 - CALLINFO.BBS
  44.                                                   WC3 - DOOR.SYS
  45.                                                    SF - SFDOORS.DAT
  46.                                                    CL - use command line
  47.  
  48. Path/name of dropfile?  Where the previously designated dropfile is created.
  49.  
  50. BBS name?  Self-explanatory.
  51.  
  52. Sysop name?  Self-explanatory.
  53.  
  54. COM port interrupt?  The interrupt of the COM port given in the dropfile.
  55.                      Valid interrupts are values 1-7.  Enter 0 to use FOSSIL.
  56.                      (Note that this is asking for the INTERRUPT number, not
  57.                       the COM port number.)
  58.  
  59.                      If you are unsure of what this value should be, here
  60.                      are the typical interrupts:
  61.  
  62.                      COM1 - IRQ4
  63.                      COM2 - IRQ3
  64.                      COM3 - IRQ4
  65.                      COM4 - IRQ3
  66.  
  67. Log errors?  Enter TRUE to write all errors encountered to a log.  Enter
  68.              FALSE to not log errors.
  69.  
  70. Here is a sample config file:
  71.  
  72.   WC3
  73.   C:\RA\DOOR.SYS
  74.   Temples of Syrinx
  75.   Scott
  76.   Stuart
  77.   3
  78.   FALSE
  79.  
  80. If your software cannot create a dropfile compatible with one of the above
  81. formats, then you must specify type CL, and run The Wall with command line
  82. parameters:
  83.  
  84. WALL <config file> <ANSI/1/GR/COLOR/TRUE> <baud> <ufirst> <ulast> <comport>
  85.                    |                      |      |        |       |
  86.                    |                      |      |        |       |-COM port #
  87.                    |                      |      |        |
  88.                    |                      |      |        |-User's last name
  89.                    |                      |      |
  90.                    |                      |      |-User's first name
  91.                    |                      |
  92.                    |                      |-Baud rate (300-115200.  0 = Local)
  93.                    |
  94.                    |-Any of these will specify ANSI on, otherwise ANSI is off.
  95.                      However, The Wall forces ANSI color so this value is non-
  96.                      consequential.
  97.  
  98. The Wall must be run from the directory in which all its files are located; it
  99. is recommended you run The Wall from a batch file such as this:
  100.  
  101.   @ECHO OFF
  102.   C:
  103.   CD \WALL
  104.   WALL.EXE WALL.CFG
  105.  
  106. To run The Wall locally from the command line, add the parameter LOCAL.
  107.  
  108.  
  109.                         - Other Command Line Options -
  110.  
  111. The following parameters can also be added to fine-tune the appearance and
  112. behavior of your Wall:
  113.  
  114. MAX=x     Sets the maximum number of lines the wall will hold (x is a number
  115.           from 1-65535).  Once x lines are on the wall, the oldest graffiti
  116.           will be removed as new lines are added.  If no limit is specified,
  117.           the size of the wall is unlimited.
  118.  
  119. RANDOM    When the wall is viewed, places the lines of graffiti randomly.
  120.           Normally, the graffiti is shown exactly how it is written (usually
  121.           left-justified), but with this parameter the graffiti is aligned
  122.           randomly.
  123.  
  124. CENTER    When the wall is viewed, centers each line of graffiti.
  125.  
  126. LINES     Separates each line of graffiti on the wall with a line.
  127.  
  128. OLDCTL    The Wall now uses the numeric keypad arrow keys to change colors while
  129.           entering graffiti; however, the controls from v1.0 are still
  130.           recognized and may be continued to be used by those who prefer them.
  131.           Use this parameter to display the old control options to the user
  132.           rather than the new ones.
  133.  
  134.  
  135.                             - Writing on The Wall -
  136.  
  137. Writing on the wall is extremely simple.  After a user has selected "W", he is
  138. prompted for a line of text, and given the option to hit TAB to change colors,
  139. or ESC to randomize text color.  Hitting TAB allows the user to change the
  140. foreground color, background color, and blink attribute.  These things are
  141. easily changed via the numeric keypad; please note that to use the arrow keys
  142. the Num Lock must be on.
  143.  
  144. Hitting ESC causes each subsequently typed letter to have a different foreground 
  145. color, and this will continue until the user presses ESC again or changes the 
  146. colors manually via TAB.  The Wall will not allow text to have the same 
  147. foreground/background color, and will not save empty entries.
  148.  
  149. The Wall's flexible color options will provide you and your users with a
  150. vivid and exciting wall.
  151.  
  152.  
  153.                              - Profanity Filter -
  154.  
  155. The Wall allows the Sysop to define a list of words or phrases not allowed to
  156. appear on the wall.  To do this, simply place all undesirable words/phrases,
  157. one per line, in a text file named CENSOR.LST; if a user attempts to enter a
  158. line of graffiti containing one or more words in this list, he will be
  159. notified that his message is not appropriate and the line will not be placed
  160. on the wall.  For a whole-word filter (i.e., filter "ass" but not "assume"),
  161. put spaces or underscores around the word in CENSOR.LST (i.e., "_ass_").
  162.  
  163.  
  164.                               - Sysop Functions -
  165.  
  166. To access The Wall's Sysop functions, view it using the (S)ysop Wall View
  167. option.  When the wall is viewed like this, a status bar appears above each
  168. line, showing who wrote it and when.  The prompt also contains three
  169. additional options available only to Sysops:
  170.  
  171. [T]runcate     Truncates the wall at the specified line number.  All entries
  172.                below the specified number are deleted.  (To delete the wall
  173.                entirely, either truncate at #1 then delete #1, or go to DOS
  174.                and delete the file WALL.DAT.)
  175.  
  176. [D]elete       Removes the specified line from the wall.
  177.  
  178. [R]eprimand    Some users like to take advantage of the anonymity of graffiti
  179.                walls and write offensive things.  This is not a problem with
  180.                The Wall; not only can the Sysop easily find out the author of
  181.                any line of graffiti, but this handy feature allows for
  182.                automatic reprimanding of such users.  The user who posted the
  183.                graffiti corresponding to the specified line number will
  184.                receive a reprimand the next time he enters The Wall; try one
  185.                on yourself to see exactly what it does.  Although this is not
  186.                a replacement for direct Sysop intervention, it is a convenient
  187.                way to handle users who may get a little out of hand.
  188.  
  189. Anyone using The Wall locally has access to these Sysop functions, and remote
  190. users can also be granted this access via inclusion in the SYSOP.LST file.
  191. As with the profanity filter file, create a text file containing the names of
  192. those users whom you wish to have access to Sysop Wall View, with one name
  193. per line.  The name must match up exactly, or no extended access is given.
  194. Whether local or remote, the Sysop defined in the config file always has
  195. access to Sysop functions.
  196.  
  197.  
  198.                               - Multinode Usage -
  199.  
  200. The Wall does not currently support simultaneous multinode usage.  If a user
  201. attempts to enter The Wall while it is already in use, he will be informed of
  202. this and brought back to the BBS.
  203.  
  204. In the event of a system crash while The Wall is in use, the door will not be
  205. able to clean up as usual; an abrupt termination of the door will cause
  206. the WALL.USE semaphore to not be deleted, thus preventing anyone from entering
  207. the door.  Please be sure to delete this manually in such a situation.
  208.  
  209.  
  210.                                 - Sysop Keys -
  211.  
  212. While a user is in The Wall, the following functions are available to the
  213. local Sysop:
  214.  
  215.  [F1] - Toggles status/help display.
  216.  [F2] - Activates chat mode.  Hit ESC to exit chat.
  217.  [F3] - Drops the local end to DOS, and displays an appropriate message
  218.         to the user.
  219.  [F4] - Kicks the user out of the door and back to the BBS.
  220. [F10] - Kicks the user out of the door and drops carrier.
  221.  
  222.  
  223.                                   - Support -
  224.  
  225. Support can be obtained by either calling the support BBS, sending NetMail, 
  226. or Internet EMail to sstuart@crow.cybercom.com.  See the section below on  
  227. registering for info on the support BBS.  Comments, suggestions, and bug 
  228. reports welcome!
  229.  
  230.  
  231.                            - Registering The Wall -
  232.  
  233. In the unregistered version of The Wall, MAX=10 is forced, and there's an
  234. unseemly delay upon exit.  However, these annoyances can be eliminated by
  235. registering, which costs only five dollars.  Please register!
  236.  
  237. Registration entitles you to free minor and major upgrades.  To register The
  238. Wall, print out REGISTER.TXT and send it to the address listed.  If your BBS
  239. is a member of FidoNet, your registration key will be conveniently sent to
  240. you.  If not, you can call the Wall support BBS to download it:
  241.  
  242.                                Temples of Syrinx
  243.                                  908/914-9807
  244.                                FidoNet 1:107/751
  245.                               RemoteAccess v2.02+
  246.                              USR Courier HST V.34
  247.  
  248. Logon using the exact name and password specified on the order form, and
  249. your registered Wall will be waiting as an EMail file attach.
  250.  
  251. To use your registration key, simply place it in the directory with all the
  252. other Wall files and rename it to WALL.KEY.
  253.  
  254. The latest version of The Wall is available on Temples of Syrinx; it can be
  255. obtained by calling the board and downloading it, or FREQing the magic name
  256. "WALL".
  257.  
  258. And if you don't already have it, FREQ "SAD" to get Search and Destroy, the
  259. popular Battleship-style door game by Scott Stuart.
  260.  
  261.  
  262.                               - Special Thanks -   
  263.  
  264. Alpha Testing Team: Dave Back           Beta Testing Sites: Bugman BBS
  265.                     Matt Edelhauser                         Sysop - Steve Mack
  266.                     Paul Tricoli                            908/506-9492
  267.  
  268.                                                             Paul's Boutique
  269.                                                             Sysop - Paul Tricoli
  270.                                                             609/PRI-VATE
  271.  
  272.  
  273.  
  274. The Wall was written using URDoor comm routines (c) 1995 Kenneth Bledsoe.
  275.  
  276. Another Brick In The Wall online graffiti wall door (c) 1995 Scott Stuart.
  277.  
  278. Distribution of Another Brick In The Wall is permissible and encouraged,
  279. providing that no fee be assessed for its distribution other than any normal
  280. fee that may be associated with the medium by which it is distributed.  The
  281. Wall must be distributed in its original archive form, unaltered and with no
  282. registration keys.
  283.